<html>
<head><meta charset="utf-8"><title>Deprecating doc(include) · rustdoc · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/index.html">rustdoc</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Deprecating.20doc(include).html">Deprecating doc(include)</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="220064507"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Deprecating%20doc%28include%29/near/220064507" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Deprecating.20doc(include).html#220064507">(Dec 16 2020 at 00:40)</a>:</h4>
<p>Per <a href="https://github.com/rust-lang/rust/issues/78835#issuecomment-742531894">https://github.com/rust-lang/rust/issues/78835#issuecomment-742531894</a>, I plan to deprecate <code>doc(include)</code> in the next beta release (and switch the standard library to <code>doc = include_str!</code> at the same time). To that end, I'm labeling all the <code>doc(include)</code> issues so I can close them when the feature eventually gets removed.</p>
<p><span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> I'll make sure it goes through FCP at the time, but does all that sounds reasonable?</p>



<a name="220097066"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Deprecating%20doc%28include%29/near/220097066" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Deprecating.20doc(include).html#220097066">(Dec 16 2020 at 10:06)</a>:</h4>
<p>I think that <code>doc(include)</code> did a bit more, so let's be sure <code>doc = include_str!</code> does the same first (unless you already did?). But then, sure!</p>



<a name="220097336"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Deprecating%20doc%28include%29/near/220097336" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Mario Carneiro <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Deprecating.20doc(include).html#220097336">(Dec 16 2020 at 10:10)</a>:</h4>
<p>Does this mean that we won't have to do <code>doc = concat!</code> indirectly in macros anymore? Because that would be great</p>



<a name="220113118"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Deprecating%20doc%28include%29/near/220113118" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Deprecating.20doc(include).html#220113118">(Dec 16 2020 at 13:12)</a>:</h4>
<p><span class="user-mention silent" data-user-id="271719">Mario Carneiro</span> <a href="#narrow/stream/266220-rustdoc/topic/Deprecating.20doc(include)/near/220097336">said</a>:</p>
<blockquote>
<p>Does this mean that we won't have to do <code>doc = concat!</code> indirectly in macros anymore? Because that would be great</p>
</blockquote>
<p>correct</p>



<a name="220113243"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Deprecating%20doc%28include%29/near/220113243" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Deprecating.20doc(include).html#220113243">(Dec 16 2020 at 13:13)</a>:</h4>
<p><a href="#narrow/stream/122651-general/topic/docs.20based.20on.20macro.20input/near/220051691">https://rust-lang.zulipchat.com/#narrow/stream/122651-general/topic/docs.20based.20on.20macro.20input/near/220051691</a></p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>